or 



^ 



OS- 9 Newsletter 



Volume I No. 11 «< BELLINGHAM 0S9 USERS GROUP >» November 31,1990 



IN THIS ISSUE: 



BUG REPORT 



SERIAL MOUSE 



SHELL+ and MODPATCH Bugs and Patches 
Microsoft & Logitech Mouse for OS-9 



ANOTHER COCO- 4 ???? 

WINDOWING 

WINDOWMAKER 



The PT68K, It's been around for years 



Introductory discussion of Windows 



Shellscript to create Windows 



SHELL+ "DATAMOD" 



Convert shellscripts to memory mods 



RAM DISK 



Take advantage of "/R0" on OS-9 



WASHINGTON OS-9 



Local Club Activitis 



OS-9 VIDEO LIBRARIES 



What's available and How much $$$ 



BENEFITS TO SUBSCRIPTION MEMBES 
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Contact: Rodger Alexander, 3404 Illinois Lane, Bellingam, WA 98226 
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SHE LL* B UG 

SheJlPlus is an enhanced version of the original 
Shell and is available on Compuserv, Delphi, 
Genie, and most CoCo/0S9 Bulletin Boards. Per- 
sonally 1 consider ShellPlus a must on any OS-9 

system. 

During the past year, several patches have been 
posted on 0S9 Building Boards/Sigs dealing with 
the "data-size" bug. 

PATCH- 1 by Paul Seniura 
Shell + has long plagued such products as RiBBS 
v2.0, Multivue Canvas and UltiMusE-111 because 
Shell I is not handling data area size properly 
when it forks or ch ains to another module. It 
should read the module's data size from it's 
header, then compare it to any overriding para- 
meters to see if the caller wants more memory 
than the module's specifications. If so, the 
program should increase this during the fork or 
chain call. 

Shell + sets a minimum data area size of $1F 
pages (31x256 bytes), almost a full 8k of RAM. 
This has been screwing up a lot of programs and 
utilities! If you program needs only 20 bytes, it 
should ONE 256-byte page, since that is 0S9's 
smallest increment of RAM for "users" programs. 
Shell + will give your program an entire 8k of RAM 
as if is presently designed -- a huge waste. 

Here's the ModPatch "Patch" file to change the 
minimum data size to ONE page of RAM: 

L shell 

C 130f If 01 

v 



There is another possible patch you can do to 
cause Shell! to reduce the 8K data size to 256- 
bytes when another process is called up requir- 
ing the initialization of another she]]. This patch 
is not a crucial as the above patch and you may 
choose not to include it into your Shell+ module. 

L shell 

C 1313 If 01 

v 

P ATCH -2 by Seattle 68xxxMUG "Gang" 
This is not a bug fix, but a "cosmetic" patch to 
cause Shell+ to boot up with a more practical/ 
user friendly 0S9 prompt. When using the 
original Shell, 0S9 would simply print "0S9:'\ 
After this patch is installed, Shell + will display a 
much more informational prompt: 
"12:30:00[Term]/D0/CMDS:" (Time [Device] / 
Path:). 

Yes you can change the Shell + prompt on the fly 
from the keyboard 



ENTER: p=" 



>' 



but you cannot change the "TERM" prompt 
automatically with a script file command line in 
the startup file. It can only be done "by hand". 
The following ModPatch "Patch" file will hard- 
wire the code into the Shell-f module: 

L shell 
C 3d 4f 29 
C 3e 53 5b 
C 3f 39 40 
C 40 5b 5d 
C 41 50 24 
C 42 5d 3a 
C 43 3a 20 
V 



MODPATCH BUG : 

Greg Law tracked down a bug in Modpatch. 
Basically, the bug shows up when you have 
modpatch scripts with single-character lines. 



When modpatch sees a line with only one char 
acter, it "skips" the entire next line 1 

* Here are some comments... 

+ The next line has only one character, so it 

* triggers the bug. 

I module 



The one-character comment line causes the "1 
module" command to be skipped. So of course 
modpatch can't find the right bytes to change! 
<Ergh!> People who have tried might notice that 
the AC1A patch floating around has this one- 
character comment line just before the "1 

aciapak" line, (oooops!) Deleting the prvious 
once character line (or making it longer) should 
avoid the bug. 
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Mouse 



You can use a "standard" serial mouse on vour 
03-9 system. Simply download "SMOUSE.AR" 
from Compuserv. Delphi, Genie or other 0S9 
Bulletin Board Services. 

SMOUSE.AR contains several "ipatch" files to 
upgrade the standard CC310 module in your 
0S9Boot to properly respond to either the Micro- 
soft mouse or the Logitech mouse. Mouse driver 
source code and definition files are also included 
in SMOUSE.AR. 

Run the Ipateh from SMOUSE.AR to the original 
MW CC310 you should wind up with a version of 
CC3I0 which incorporates both Kent Meyer's 
patches and the serial mouse patches. Once 
you've installed the serial mouse on your RS-232 
Pak (/T2 pak) you will not be able to use that 
serial port for a modem unless you unplug the 
mouse and re -boot with an OS 9 disk that has 
the regular CC310 and ACIAPAK+T2 installed in it. 



Ill be uploading an improved CC3I0 patch soon... 
if you get the mouse working you'll want to 
watch for that one. I'll also be uploading patches 
for the regular CC310 and Tandy Colour Mouse 
because it really improves IRQ response. 

- -Bruce Isted, Delphi — 

Editor's Note: Besides Bruce lsted ; s SMOUSE.AR 
file, you will also need Bob Santy's IPATCH utiliy 
and of course the AR (archiving) utility. All of 
these files are available for downloading from 
Compuserv, Delphi, Genie, etc. They may also be 
available from your local 0S9 computer club's 
Public Domain Library. 




For all of you who are debating about which new 
computer to buy.. .the MM/1 or the Tomcat. ..add 
another to your list. This computer has been 
around before the other two were even con- 
ceived. It's called the PT68K-4 and here are 
some of the features: 



-68000 CPU running at 12 or 16 MHz 

--512k to 4096K of RAM on main board 

--Optional memory board supports up to 

--Four RS232 ports 

--Supports MFM hard drive 

— FD controller supports 360K, 720K, ].2M, and 

1.44M drives 
--Battery backed clock on -board 
--Two 8-bit parallel ports 
-■-Seven XT-compatible expansion ports. 
--Mounts m standard XT or baby AT cabinet. 

and uses std. IBM-style pwr supply. 

Since this computer has XT-compatible slots, 
you can use readily-available CHEAP cards to 



expand' 0S9 68K is available with editor/assem- 
bler and Mieroware C compiler. CGA/EGA/VGA 
cards are supported by this machine. VGA is 
currently supported in 320 x 200 x 256 and 800 x 
600 x J 6 modes under 0S9. They are planning to 
write device drivers for Super VGA early next 
year. Also, there is supposed to be a public 
domain program that allows the user to set up 
multiple windows and hot-key between them 
(similar to what we're used to on the CoCo 3) 

For more information, write: PERIPHERAL TECH- 
NOLOGY 1480 Terrell Mill Rd. Suite 870 Marietta, 
GA 30067 1-404-984-0742 



-David Philipsen, Delphi 
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WINDOWS 

by Mike Pleas 
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One of the things you've been 
hearing a lot about in OS-9 Level 
Two windows. What I will attempt 
to do in this article is give you 
a little primer on windows and how 
they work* 

First of all, a window is a 
graphic screen that routes infor- 
mation from other parts of the 
system (in OS-9) to the terminal. 
This is not to be confused with 
graphics (a whole different ani- 
mal altogether). In other words, 
windowing is a way of creating 
separate but connected environ- 
ments to do your work or the 
computer's work. Think of them as 
different devices like the disk 
drive or the printer. 

Unlike the devices mentioned 
above, windows are made in and 
exist in software only. They are 
only figments of the computer's 
mind! 



Let's go to an analogy to make 
windowing a little more down to 
earth. Consider a window as a 
container or box. Windows come in 
many sizes and shapes. So let's 
say we create a bunch of windows 
(level 2 can handle up to 16 
windows at one time). These 
windows can vary in size anywhere 
from pixel size to filling up the 
whole screen. And if a window is 
smaller then a screen it can be 
located anywhere within the 
screen. Wait, there's more! 
Windows can be located off screen 
or even on top of/within each 
other . 

Back to the boxes. Okay, we've 
got these boxes of different 
sizes. Now punch a little hole in 
each box and connect tubes between 
each box. These tubes are ex- 
tremely flexible so that the boxes 
can be shifted around each other 
or even on top of each other and 
still remain attached. What are 
the tubes for? Well, the pipes 
are little conduits to pass infor- 
mation back and forth between 
these boxes. 

Now we go back to the real world. 
You've got OS-9 booted up and 
you're looking at the terminal 
screen. You've created several 
boxes, ummmm, I mean windows. You 
hit <CLEAR> and the screen changes 
to a different color and usually 
is empty except for the prompt. 

You're now in your first window. 
Big deal! Right? Well, try 
typing: xx dir >/term' ' . Nothing 
happen? Okay, now hit <CLEAR> 
again. There's the directory on 
the original screen. 



What we did was switch from the installment I'll go into more 

terminal screen to the first win- detail on overlays. If you can't 

dow and send a directory command wait, I suggest you get xx The 

back to the terminal screen (>/ Complete Rainbow Guide to 0S9 

term). Remember the tubes? Not Level II" by Dibble and Puckett 

only can you send info in that (you can get it an any Radio 

direction but the other way too. Shack). 

This is accomplished by typing To summarize, windows are soft- 

(from the terminal screen) xx dir ware devices that handle all in- 

>/w" . Now here's a listing in formation going to the screen, 

that window. You can send just Each window can handle informa- 

about any command back and forth tion flow through itself at the 

this way. In other words, sepa- same time as any or all the other 

rate environments but connected. windows are handling there own 

information flow OR back and forth 

For those of you a little new to as I have shown. Of course, these 

the system, the ">" command examples are very primitive and 

means the characters immediately the possible applications for 

following are a device. Obvi- windowing in OS9 are limitless, 
ously, then v V w ' ' means xx device 

window' 7 . The windows are num- — Mike Pleas 

bered /w to /wl5 and are given — Bellingham OS-9 Users Group 
their labels by their creator. 
The command to create a window is 
x * init /Wxx ' ' . Try * x init /w4 ' ' 
or * x init /w7", then xx shell i-/ 
w4 " or x A shell i=/w7 ' ' . 



WINDOWMAKER 

Shell+ scriptfile 
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I'll go into one other aspect of WINDOWMAKER is a x ^scriptfile' ' 

windows. Remember my mentioning just like your Startup file for 

the boxes inside the boxes? These 0S9 Level-II with Shell+. WINDOW- 

are the overlay windows. If MAKER prompts the user for the 

you've ever used those big fancy window Number and then prompts for 

programs of .big blue or big mac or the x *type" of window desired, 

even multivue, you've seen those Notice the x% VAR''iable and 

pulldown or popup windows. Guess xx Prompt'' functions, 
what? We can do this too! All 

they are are overlay windows. In shell+ is available on DELPHI, 

other words, they're temporary COMPUSERV, BASE ACCUMULATOR (206- 

windows that print themselves 455-3410), BBQ-RiBBS (206-676- 

over the existing screen and when 5787), FAR POINT STATION (206- 

you're done with them, they de- 285-8335), and DATA WAREHOUSE 

stroy themselves. I can't go into (509-325-6787). 
details on overlays at this point 

because it is a bit complicated Listing: 

for this article. In the next els 



echo 

echo WMAKER 

echo window maker with typeset 

echo by Ken Heist 

merge /h0/sys/stdpats_4 /hO/sys/ 

stdptrs /hO/sys/stdfonts >/w 
echo 
echo 

echo TYPES: 

echo 1 40x24 text 8c 2Kmem. 
echo 2 80x24 text 8c 4Kmem. 
echo 5 640x192 graphic 2cl6Kmem. 
echo 6 320x192 graphic 4cl6Kmem. 
echo 7 640x192 graphic 4c32Kmem. 
echo 8 320x192 graphicl6c 32Kmem. 
echo 

Prompt Choose Window (1-15): 
var.O 

Prompt What Type: 
var.l 
if %1=1 

iniz w%0 

display lb 20 1 28 18 1 
1 >/w%0 

display lb 31 1 18 lb 32 lb 
33 1 lb 34 1 >/w%0 

shell i=/w%0& 

echo Typel 40x24 Text 8c 
2Kmem. >/w%0 
else 
if %1=2 

iniz w%0 

display lb 20 2 50 18 
1 1 >/w%0 

display lb 31 1 18 lb 32 

lb 33 1 lb 34 1 >/w%0 

shell i=/w%0& 

echo Type2 80x24 Text 8c 
4Kmem. >/w%0 
else 
if %1=5 

iniz w%0 

display lb 20 5 50 18 
1 2 >/w%0 

display lb 3a c8 01 >/w%0 

display lb 32 lb 33 1 lb 
34 2 >/w%0 





shell i=/w? 


>0& 






echo Types 


640x192 Graphi 


2c 


16Kmem. >/w3 


>0 




eli 


se 






if 


%1=6 
iniz w%0 








display lb 


20 6 


28 18 




1 2 


> >/w%0 






display lb 


3a c8 01 


>/w%0 




display lb 


32 lb 


33 1 lb 




34 


2 >/w%0 






shell i=/w? 


>0& 






echo Type€ 


i 320x192 Graphic 




4c 16Kmem. > 


/w%0 


else 






if 


%1=7 
iniz w%0 








display lb 


20 7 


50 18 




1 2 


! >/w%0 






display lb 


3a c8 01 


>/w%0 




display lb 


32 lb 


33 1 lb 




34 


1 >/w%0 






shell i=/w%0& 






echo Type7 


' 640x192 


Graphic 




4c 32Kmem. > J 


/w%0 


else 






if 


%1=8 
iniz w%0 








display lb 


20 8 


28 18 




1 2 


; >/w%0 






display lb 


3a c8 01 


>/W%0 




display lb 


32 lb : 


33 1 lb 




34 


2 >/w%0 






shell i=/w% 


0& 






echo Type8 


320x192 


Graphic 




16c 


32Kmem. : 


>/w%0 


else 






endif 
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° RAM DISK 

by F. Calcraft 
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I have found some great ways to 
make use of a RAM disk. Of course 
a RAM disk is a good place to store 
files temporarily (archives or 
bootfiles, for example) but I also 
discovered that after adding and 
deleting files to a disk over an 
extended period of time, one ends 
up with a lot of file fragments 
and scattered small blocks of free 
sectors. It is possible to put 
most of those free sectors to- 
gether and end up with more total 
empty space as well. 



to reformat the floppy first if it 
is well used. 

ENTER: free /dO 

You will probably find that the 
number of free sectors is 
larger, as well as the largest 
block. 

Here is how you can use your RAM 
disk to to a single swap backup: 

ENTER: format /rO 

This must be done before RAM drive 
can be used 

ENTER: backup /dO /rO #4 Ok 
source to RAM 



Assume that the floppy needing ENTER: backup /rO /do #40k 
reorganizing is /dO. The command r^ to destination 



ENTER: free /do 

Shows total free sectors and larg- 
est block of sectors and shows 
name of disk (important!) 

ENTER: format /rO 

At the name prompt, give the 
RAMdisk the name displayed by 
FREE (do not include the guotes) 

ENTER: dsave -bs35 /dO /rO ! 
shell -x-p 

This will copy the whole floppy 
contents file by file, 
including the boot. 

ENTER: backup /rO /dO #40k 

This will back up the RAM disk to 
original floppy. You might have 



This saves the frustration and 
bother of having to sit there and 
swap disks back and forth in the 
drive. Since I have the odd 
combination of a double-sided 
drive and a single-sided drive, I 
use the trick to backup the /d2 
side of a disk. 
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Tymnet and Telenet are local tele- 
communications * * nodes ' ' that 
permit us to call Compuserv or 
Delphi or Genie without having to 
pay long distance charges. 

Telenet offers a way to tell it 
you're about to transfer a LOT of 
data. It xx Prepares the network 



for bulk file transfers. '' 
(quoted from the Telenet booklet 
which you can get for free by 
calling them up at 1-800-336- 
0437) 

Just, before you start download- 
ing, get back to the Telenet 
command prompt. To do this, type 
A @' <Enter> ( x At-sign' 
x Enter') Note that the % @' must 
be the first character typed after 
the previous carriage return. You 
may have to type * Enter' x @' 
* Enter' if you've typed other junk 
and are not at a fresh prompt 
within Delphi (or whatever). 

Now, at the Telenet prompt, type: 
DTAPE <Enter> 

I believe this returns you to 
connected mode. (If not, you'll 
see another Telenet prompt, at 
which you type CONT <Enter> to get 
back to connected mode.) Now do 
the download. When the download 
is finished, send a break (a true 
line-break) to get out of DTAPE 
mode. 

Basically, when you enter DTAPE, 
Telenet optimizes itself for bulk 
file transfers rather than being 
optimized for a login session and 
ASCII text etc. 

You'll probably want to get out of 
this mode when you're done trans- 
ferring files. Esp if you're 
going to read the forums, and 
perhaps more especially if you're 
going to talk in a conference! If 
all you're doing is downloads, it 
may not be worth the effort of 
entering and leaving this mode for 
each file transfer! I've not 



tried it myself , and I'd be very 
happy to hear any comparisions of 
transfer speeds with DTAPE on & 
off. 

With some terminal programs, you 
may be able to automate all of the 
above into a macro. 

— Ed Kuns, Internet — 




The Mount Rainer Color Computer 
Club meets every month on the 
second tuesday at the new Par- 
kland/Spanaway Library on 138th, 
and Pacific Ave. We start around 
7:00 pm, and end around 8:45 pm. 

Each meeting we have two to three 
speakers on various subjects. Our 
past meetings we have had speakers 
on: 

1. MM/1 and TC/9 comparison 

2. OS-9 Help 

3 . DynaCalc 

4 . Phantomgraph 

5. Hard Drives 

6. 80 Track Drives 

7. And a whole lot more. 

The president is Erich P. Sweaney, 
he is the youngest attendant. He 
has published his own newsletter 
from June 1989 through June 1990, 
and have had several articles 
published from other magazines, 
and had national reviews on his 
projects. 

Other attendants of our meeting 
include Otto Schliep, vice presi- 
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dent, he is one of our disk 
drives, and hardware experts. 
Then their is our Alan Johnson, he 
is in charge of calling some of 
the attendants and reminding 
people of the meetins, he is a 
very knowledgable with OS-9 , RS- 
Dos, Unix, and C. Our other atten- 
dants all contribute to our meet- 
ings from their knowledge. 

Our group activites through out 
the year has been car pooling up 
to other groups meetings, attend- 
ing local computer fairs, and 
contributing to newsletter with 
articles and or programs. We do 
not charge any of our attendants 
for membership, we have also been 
this way and will probably never 
change . 

Once in a while if we have a member 
who has something to sell, we 
kinda of have a little swap within 
our group meeting. And we most 
always leave the last fifteen to 
twenty minutes for an open discus- 
sion. 

If you would like to attend one of 
our meetings, or have any ques- 
tions you would like answered, 
please give me a call at 535-9733 
and ask for Erich Sweaney. 
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Recently I attended the Kitsap 
Computer Society. This is a group 
of the various machine groups that 
are in the county. I told them 
about the FCC rules and policies 
regarding the broadcasting of 
community productions. They were 
VERY excited about it. Now we 
have to get a production going. 

We thought of having about half 
the time to a topic like BASIC and 
then something about a piece of 
software and then a quick overview 
of the clubs. The programs would 
be 30 minutes and aired once a 
month. This would be underwritten 
by the various computer stores in 
the area to give us a budget for 
supplies, tape, and maybe a little 
walk-away money for those in- 
volved. 

Another project that Port O'CoCo 
is involved in is the Computer 
Swap meet in the Kent Commons, 
(Kent, WA) on December 8th where 
we set up a CoCo informational and 
demonstration booth. There is 
also going to be a Computer Fair 
in the Kitsap Mall in Silverdale 
the 15th-16th of December. 

Donald Zimmerman, Port O'CoCo 
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The following BBS list will be of interest to CoCo 
and 0S9 users: 



FAR POINT BBS (Seattle) 

(206) 285- 8335 BasicOO RiBBS (Fido NET) 

COLUMBIA HTS. BBS (Longview) 

(206) 425-5804 Basic09 RiBBS (Fido NET) 

DATA WAREHOUSE BBS (Spokane) 
(509) 325-6787 Level -II 0S9 BBS 

TIME MACHINE BBS (Tri- City) 
Y)\ ™«-2559 CoBBS 



BARBECUED RIBBS BBS (Bellingham) 
(509) 676-5787 PC-Board 



SUBSCRIPTON BENEFITS 
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As a subscriber to the OS- 9 NEWSLETTER, you are 
also a member of the Bellingham 0S9 Users 
Group, and as such you enjoy the following 
benefits: 

1. Monthly Newsletter 

2. Public Domain Librar (5 Megabytes) 

3. Technical help on call 

4. Free Classified Ads 

5. 0S9 BBS with over 200 downloadable files 

6. Membership list 

7. "How To" Video Library 
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SUBSCRIPTION NOTICE: If you are not already sub- 
scriber to OS9 Newsletter, then consider sending in 
your check now ($3/6 months or $6 for 12 months). 
On January 1st the subscription rates will increase 

lo $5 k $10. (still cheap!) 
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NOTICE TO CLUB PRESIDENTS: Be sure to post or 
mail in your January meeting agenda prior to 
December 28th so that they may be included in 
the January issue of 0S9 Newsletter. 



